home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / os2 / inid11e.zip / INISHARE.TXT < prev   
Text File  |  1992-10-12  |  16KB  |  333 lines
  1.                          INIMAINT
  2.                  Copyright 1992, Carry Associates
  3.  
  4. INIMAINT is an OS/2 PM program to display and manage *.INI files and
  5. is distributed by Carry Associates, 124 Doe View Lane, Pound Ridge,
  6. NY, 10576. Telephone number is 914-764-4390. The application was
  7. written by and is supported by Larry J. Martin. You can obtain
  8. Technical support by calling the number above, by leaving an Email on
  9. Compuserve for 71435,470 or for the same ID in Section 9,
  10. Applications, on the IBMOS2 Compuserve Forum.
  11.  
  12. WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  13.  
  14. INIMAINT gives you the ability to make virtually any change you want
  15. to any of the INI files in your OS/2 environment. Making changes to
  16. these files must be done with care because you can do serious and
  17. unpredictable damage to your environment. It is STRONGLY SUGGESTED
  18. that you insure that you have a usable backup of any INI file that
  19. you modify in any way.
  20.  
  21. WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  22.  
  23.                      SHAREWARE VERSION
  24.  
  25. The version of INIMAINT that accompanys this documentation is a
  26. Shareware version of the program that must be registered with Carry
  27. Associates, if you intend to use it except for a brief test. This is
  28. not a free program and has been Copyrighted by Carry Associates. It
  29. is a violation of the Copyright Laws to use the program without
  30. registering and paying for it. The purpose of the unregistered
  31. version is ONLY to give users an opportunity to try the program so
  32. that they can determine whether they feel the program is worth the
  33. $29.95 cost.
  34.  
  35. Unregistered copies of INIMAINT will display an initial dialog that
  36. will note the unregistered condition. This dialog will stay on the
  37. screen for 15 seconds, unless dismissed by clicking on the OK button.
  38. The dialog cannot be dismissed until it has been visible for 3
  39. seconds. In addition, the Title Bar will contain a note that this is
  40. an unregistered version of INIMAINT.
  41.  
  42. To obtain your registration identifier please send a check for $29.95
  43. per license for single licenses or $299 for an unlimited copies
  44. license made payable to:
  45.  
  46. Carry Associates
  47. 124 Doe View Lane
  48. Pound Ridge, NY 10576
  49.  
  50. INIMAINT was written by and is support by:
  51.  
  52. Larry J. Martin
  53. Tel: 914-764-4390
  54. Fax: 914-764-0336
  55. Compuserve: 71435,470
  56.  
  57. Once you have your registration identifier, you can register your
  58. copy of INIMAINT by selecting the :hp2.Register Your Copy:ehp2. entry
  59. on the Actions Menu. Once you are registered, this entry will no
  60. longer appear on the menu.
  61.  
  62. If you want a preregistered copy of INIMAINT, add $7.00 for postage
  63. and handling. We will return a diskette with a preregistered copy of
  64. INIMAINT, an Install CMD file and an INIMAINT registration ID. The
  65. purpose of the ID is to allow preregistered users to download new
  66. versions, register and use them until they can obtain a preregistered
  67. update. The preregistered version will run as registered without any
  68. need to register it on each system.
  69.  
  70. The cost of a preregistered update is $10.00 per license for single
  71. licenses or $100.00 for an unlimited copies license, plus $7.00
  72. handling and postage.
  73.  
  74.  
  75.                       CURRENT VERSION
  76.  
  77. The enclosed is Version 1.1e of INIMAINT and has the following
  78. known problems and/or incomplete features:
  79.  
  80. 1. The Install must be done manually.
  81.  
  82. 2. Long Filenames are not supported.
  83.  
  84. 3. The Initial Dialog cannot be dismissed using the Enter Key, the
  85. Mouse must be used.
  86.  
  87. 4. If the Groups Dialog is displayed, a new Group is selected and
  88. then OK is selected without actually making any changes to any of the
  89. Groups or the Applications in a Group, then the Last Group Displayed
  90. is not updated and a subsequent use of the Groups Dialog will revert
  91. back to the previous Last Group.
  92.  
  93.                  REPORTED COMMENTS OR PROBLEMS
  94.  
  95. The following items are problems that have been reported, but cannot
  96. be reproduced or comments that I have received from one or more
  97. users. Any assistance on the problems or additions to the comments is
  98. more than welcome.
  99.  
  100. 1. It was pointed out that although the Cursor in the Value MLE can
  101. be an Insert Cursor, there is no way to Insert information. My
  102. response is that the only way to change the length of a Value is by
  103. using the Replace Value Dialog because changing the expected length
  104. of an INI Key Value can cause unusual and unexpected errors. I
  105. further responded that the only way to change the cursor is to
  106. change it System wide, therefore, changing it only when it is in the
  107. MLE is a non trivial problem and I have not attempted to do it even
  108. though it leaves the apparent conflict between the appearance of the
  109. Cursor and the actual effect when a key is depressed.
  110.  
  111.                         INSTALLATION
  112.  
  113. To install the beta version you must:
  114.  
  115. 1. Copy the INIMAINT.EXE and INICOPY.EXE files to a subdirectory that
  116. is included in the PATH environment variable in your CONFIG.SYS.
  117.  
  118. 2. Copy the INIMTAPI.DLL file to a subdirectory that
  119. is included in the LIBPATH environment variable in your CONFIG.SYS.
  120.  
  121. 3. Copy the INIHELP.HLP file to a subdirectory that
  122. is included in the HELP environment variable in your CONFIG.SYS.
  123.  
  124. 4. You may optionally add INIMAINT to one of the Groups on your
  125. Desktop.
  126.  
  127.                         OPERATION
  128.  
  129. To run INIMAINT simply start it by clicking on the INIMAINT.EXE file
  130. or start it from the Group to which it has been added. When INIMAINT
  131. first comes up, it will default to editing the INI file that is
  132. identified by the system as the user INI file. This is normally
  133. C:\OS2\OS2.INI. The name of the current file is always displayed in
  134. the TITLE bar of the main window.
  135.  
  136. INIMAINT can also be started with an initial INI file specified on
  137. the command line. This allows INIMAINT to be started with a new file
  138. by using the command line, but also allows for it to be started by
  139. dropping a file on the ICON on the desktop or double clicking on an
  140. INI file, once the association is set up.
  141.  
  142. INIMAINT will locate the window in a default location, but you can
  143. move and or size the window as you choose. When INIMAINT is shut
  144. down, it will remember the file that it was currently working with as
  145. well as the size and location of the window and will restore all of
  146. these the next time it is run.
  147.  
  148. There are a number of INIMAINT functions which will take some time
  149. to execute. For example, the maximum length Key Value that INIMAINT
  150. will load into the Key Value Window is 60,000 bytes. Since each line
  151. only displays 8 bytes, this comes to 7,500 lines and it takes well
  152. over a minute. There are other similar types of functions, although
  153. the example is the longest. During these long operations, it is not
  154. possible to do any other INIMAINT operations. However, the long
  155. functions are done in separate threads and the Message Queue is not
  156. blocked, therefore it is possible to go do some other, non-INIMAINT,
  157. function during this time. In addition, since there are a number of
  158. reasons why a user might not want to wait until the lengthy function
  159. is completed, for example, it might have been selected in error,
  160. any INIMAINT operation that takes a long time and displays the Wait
  161. Pointer can be terminated by hitting the ESC key.
  162.  
  163.                    MAIN WINDOW DESCRIPTION
  164.  
  165. The Main Window contains three standard child windows. Two of these
  166. windows are Listboxes and the third is a MLE.
  167.  
  168. The upper left Listbox will always contain the list of Applications
  169. for the current INI file.
  170.  
  171. The upper right Listbox will contain the list of Key Names for the
  172. Application that is currently selected in the Application Listbox.
  173.  
  174. The MLE, at the bottom, will contain the hex and ASCII display of the
  175. contents of the Key Name that is selected in the Key Listbox.
  176.  
  177. The Cursor will normally be forced to the MLE and the value of the
  178. data can be modified by changing either the hex or the ASCII fields
  179. of the MLE. The cursor cannot be moved to any portion of the MLE that
  180. does not contain data that can be modified and any modification to
  181. one type of data, hex or ASCII, will immediately be reflected in the
  182. other data.
  183.  
  184. The actual data in the INI file is not changed until the user selects
  185. the Update Item on the Action Menu or selects a different Key or
  186. Application in the same INI file. At this time, you will be asked to
  187. confirm that you want the INI file modified, unless you have turned
  188. the warning option off, see below.
  189.  
  190.                  INIMAINT MENU OPTIONS
  191.  
  192. The various INIMAINT Menu options are:
  193.  
  194. 1. File gives the user the ability to change INI files, refresh the
  195. current INI file, Dump the contents of the INIMAINT variables,
  196. compare two INI files and Exit from INIMAINT.
  197.  
  198. The Compare option allows the user to Compare two INI files on any
  199. one of three different levels:
  200.    A. List Applications that are in one INI file, but not the other.
  201.    B. A. above plus any Key Names that are in one file, but not the
  202.       other.
  203.    C. A. and B. above plus any Key Values that are in both files, but
  204.       are not equal.
  205. The differences are displayed in a Listbox within a Dialog that
  206. allows the user to print or write a listing of the Listbox contents
  207. and/or create an INI file with some or all of the Applications or
  208. Keys that have differences.
  209.  
  210. 2. Options will display a Dialog that gives you the ability to:
  211.    A. Turn off the display of the opening INIMAINT Dialog.
  212.    B. Turn off the dialogs that will ask for confirmation before
  213.       Deleting or Modifying the contents of the Current INI file.
  214.  
  215. 3. Groups will display a Dialog that allows you to define and manage
  216. the various Groups for this INI file. A bit of explanation is needed
  217. here. INIMAINT gives the user the ability to arrange the applications
  218. in any INI file into Groups. These Groups can then be used in a
  219. number of different INIMAINT areas and greatly ease the problems of
  220. handling an INI file with a large number of applications. For
  221. example, the OS2.INI file might be divided into two Groups, System
  222. and Private. The System Group would be the applications put in the
  223. file by OS2 Install and the Private Group would be the remaining
  224. applications. More or fewer Groups could be defined. How the user can
  225. use Groups within the INIMAINT structure will become more clear
  226. below. The Groups Dialog gives the user the ability to define new
  227. Groups, to add and delete Applications and Delete Groups.
  228.  
  229. The procedure for establishing a new Group is to select Groups in the
  230. Group Dialog, select New Group, and supply a name. Once this is done,
  231. the Title of the Dialog will show the current Group and the new Group
  232. will be added to the Group Menu. You add Applications to the Group by
  233. selecting them in the Listbox.
  234.  
  235. The Listbox will display a specific Group or, if you want to know if
  236. there are any Applications that are not in a Group, will display all
  237. Groups. A single Application can be a member of up to 5 different
  238. Groups at any one time, so it is possible to define overlapping
  239. Groups.
  240.  
  241. 4. Size will calculate the minimum amount of Disk Space that would be
  242. required for an INI file that contained a selected set of
  243. Applications in the current INI file. When this item is selected, the
  244. user will be asked what he wants to Size. There will always be two
  245. choices, the current file and the currently selected Application. If
  246. there are any Groups defined, then they will be included among the
  247. selections. If there are more than one Group defined, then there will
  248. be an All Groups selection.
  249.  
  250. 5. Actions gives the user the ability to do a number of things:
  251.    A. Update Current Key will write any changes that have been made
  252.       to the data in the MLE into the current INI file.
  253.    B. Delete Application and Delete Key will do the obvious.
  254.    C. Add Application, Add Key and Replace Key Value are all the same
  255.       function except entered at different points. Add Application
  256.       will ask for the name of a new Application to add to the
  257.       current INI file and then fall through to the Add Key, since
  258.       the Applications must have at least one Key. The Add Key will
  259.       ask for the name of the new Key and then fall through to the
  260.       Replace Key Value, since any Key Name must have an associated
  261.       Value. This will cause the Key Dialog box to be displayed. The 
  262.       Application and Key Names will be shown at the top of the
  263.       Dialog, followed by the current length of the data, the ASCII
  264.       representation of the data and the hex representation of the
  265.       data. This is the only option that will change the length of
  266.       a Key Value. Care must be taken when doing this, as many
  267.       applications depend on knowing the length of the INI items. As
  268.       the ASCII or hex values are changed, the changes will appear in
  269.       the other window and the length will be updated. The only
  270.       exception is when only a single hex digit is entered. The ASCII
  271.       window is not updated until two hex characters are entered.
  272.    D. Rename and Duplicate Key give the user the ability to change
  273.       the name of an existing Key or to make a duplicate copy of the
  274.       Key using a different Key Name.
  275.    E. Copy and Move will ask the user to select a Target File for the
  276.       Copy/Move and will then give the user the same choices as Size
  277.       above. The selected Applications will then be moved or copied
  278.       to the Target INI file, which will be created, if it does not
  279.       exist. This function is done Key by Key, so it will sometimes
  280.       take some time. However, the PM message queue is not blocked
  281.       while the move/copy is being done. The actual move or copy is
  282.       done by a separate program INICOPY, that can also be run as a
  283.       batch program, see below.
  284. 6. Recover contains a list of capabilities designed to give the user
  285. the ability to recover from corrupted INI files. These capabilities
  286. are:
  287.    A. Change User and/or System INI Files give the user the ability
  288.       to change the INI files that OS/2 is currently using to new
  289.       files. The primary use of this capability is to allow the user
  290.       to make changes to the User or System INI files that he knows
  291.       need to be made, but cannot make to the current User or System
  292.       Files because of protection built into OS/2. Great care must be
  293.       exercised when doing this, but it will sometimes represent the
  294.       only way that problem entries can be removed from an INI File.
  295.  
  296. 7. Find allows the user to search the Application Listbox, the Key
  297. Name Listbox, the Key Value MLE, all of the Key Names in the currrent
  298. INI file, all of the Key Values for the current Application or all of
  299. the Key Values in the current INI file for either an Ascii string or a
  300. Hex value.
  301.  
  302.                              INICOPY
  303.  
  304. INICOPY is the program that is used by INIMAINT to do the actual
  305. COPY/MOVE operations. This option is implemented as a separate program
  306. so that the user will have the ability to make copies of INI files,
  307. including the User and System INI files, at any time during the day.
  308.  
  309. The parameters expected by INICOPY are:
  310.  
  311. Required Parameters:
  312.  
  313. -Ifilename  - The fully qualified path and filename of the Source,
  314.               Input, INI file.
  315.  
  316. -Ofilename  - The fully qualified path and filename of the Target,
  317.               Output, INI file. The Target will be created if it does
  318.               not exist.
  319.  
  320. Optional Parameters:
  321.  
  322. -Fx         - Function requested - Default is C(opy)
  323.               C = C(opy)
  324.               M = M(ove)
  325.  
  326. -E          - COPY/MOVE Entire INI file - Default
  327.                                             
  328. -A          - COPY/MOVE All Groups
  329.                                              
  330. -Ggroup     - COPY/MOVE Specific Group
  331.                                              
  332. -Sapp       - COPY/MOVE Specific Application
  333.